Java知识体系

Appearance

Spring AI Alibaba

知识点清单 ​

  • [ ] Spring AI Alibaba 是什么？与 Spring AI 的关系？
  • [ ] 多智能体编排模式（Sequential / Parallel / Routing / Loop）
  • [ ] Graph 工作流编排的基本概念
  • [ ] 模型接入：DashScope（百炼）/ OpenAI 等
  • [ ] Tool Calling 与 MCP 协议支持
  • [ ] A2A（Agent-to-Agent）分布式协作
  • [ ] 上下文工程（Context Engineering）
  • [ ] 多模态支持（文本 + 图片）
  • [ ] Admin 可视化开发工具
  • [ ] 语音智能体（Voice Agent）

笔记 ​

一、定位 ​

Spring AI Alibaba 是阿里巴巴开源的 Java Agentic AI 框架，基于 Spring AI 之上构建，面向企业级生产环境。可以理解为：Spring AI 提供标准抽象，Spring AI Alibaba 提供阿里云生态的 开箱即用实现 + 增强能力（多智能体编排、Graph 工作流、可视化运维等）。

与 Spring AI 的关系：

  • Spring AI Alibaba 依赖 Spring AI，在其基础上扩展
  • 复用 Spring AI 的 ChatModel、Tool、MCP 等标准抽象
  • 额外提供阿里云 DashScope（百炼）模型接入、Nacos 服务发现、多智能体编排等

二、核心能力 ​

1. 多智能体编排

内置多种编排模式，无需从零实现：

模式说明
SequentialAgent按顺序执行多个 Agent
ParallelAgent并行执行多个 Agent
RoutingAgent根据条件路由到不同 Agent
LoopAgent循环执行直到满足退出条件

2. Graph 工作流

基于图的运行时引擎，支持条件路由、并行执行、状态管理。可将复杂 Agent 逻辑可视化编排，导出为 PlantUML / Mermaid。

3. Tool Calling 与 MCP

  • 支持标准的 Function Calling
  • 完整支持 MCP 协议，Server 端可通过 HTTP/SSE 暴露工具
  • 内置 40+ 预置工具：搜索、翻译、地图、新闻等

4. A2A（Agent-to-Agent）

集成 Nacos 实现分布式 Agent 协调，不同服务的 Agent 可互相发现和调用。

5. 上下文工程

内置最佳实践：人机协作（Human-in-the-Loop）、上下文压缩、动态工具选择、工具重试等。

6. 多模态

ReactAgent 支持文本 + 图片输入，以及基于工具的图片/音频生成。

7. Admin 工具

提供本地可视化开发界面：Agent 开发、调试、评估、MCP 管理。

三、生态项目 ​

项目说明
Spring AI Alibaba Graph底层编排框架与运行时
Spring AI Alibaba Admin本地可视化开发工具
JManusJava 版通用智能体平台（阿里内部已使用）
DataAgent自然语言转 SQL
DeepResearch基于 Graph 的深度研究智能体

四、快速开始 ​

xml
<dependency>
    <groupId>com.alibaba.cloud.ai</groupId>
    <artifactId>spring-ai-alibaba-starter</artifactId>
    <version>1.1.2.2</version>
</dependency>
yaml
spring:
  ai:
    dashscope:
      api-key: ${DASHSCOPE_API_KEY}
java
@RestController
public class ChatController {
    private final ChatClient chatClient;

    public ChatController(ChatClient.Builder builder) {
        this.chatClient = builder.build();
    }

    @GetMapping("/chat")
    public String chat(@RequestParam String input) {
        return chatClient.prompt(input).call().content();
    }
}

五、与 AgentScope Java 的关系 ​

Spring AI Alibaba 已深度集成 AgentScope Java 作为底层多智能体引擎。可以理解为：

  • AgentScope Java = 底层 Agent 运行时（ReAct 引擎、沙箱、多智能体协作）
  • Spring AI Alibaba = 上层应用框架 + Spring 集成 + 阿里云生态

详见 框架 Agentscope-java